USERNET

 USERNET.EXE (USERNET) is a utility which allows you to modify the contents
 of your USERNET.XXX file.  What is your USERNET.XXX file you ask?  The
 USERNET.DAT file is where information is stored about who is online, where
 they are from, and what they are currently doing.  The USERNET.XXX file is
 also the file that is used to determine if users are available for chat and
 to display who is online via the WHO command.  An example WHO command looks
 like this:

 (#)   Status                  User
 ---   ---------------------   -----------------------------
   1   Available for CHAT      JIM SHELBER (PLANTATION, FLORIDA)
   2   Logging into System
   3   Available for CHAT      KIM KARBO (SALT LAKE CITY, UT)


 As you can see it shows that the SysOp is on node 1 and unavailable for node
 chat.  This display also shows that the SysOp is from ANYTOWN, ANYWHERE.

 What Can You Do With USERNET?

 You can do all sorts of things with USERNET.  Below are some sample uses:

 -Change the name of someone in USERNET.DAT
 -Change the city of someone in USERNET.DAT
 -Immediately drop everyone off of the BBS if they are in PCBoard
 -Delete names out of USERNET.DAT that are "stuck"
 -Add nodes and users that do not really exist (up to your node limit)
 -Show that a node is currently running an event

 As you can see there are quite a few things you can do with USERNET.
 If you use your imagination you can come up with several other uses.

 Syntax

 USERNET [filename] [nodenum] [status] [name] [city] [text]

 filename = Specifies the full path and filename of the USERNET.XXX file
            to use.
 nodenum  = Specifies the node number you want to edit or ALL to modify all
            nodes.
 status   = Specifies the status the node(s) will be set to.  For a list of
            status values, see the Status Values heading in this section.
 name     = Specifies the name of the caller (up to 25 characters) or * to
            leave the name unchanged.
 city     = Specifies the city or location of the caller
            (up to 24 characters) or * for no change.
 text     = Specifies the text (up to 48 characters) to place in the
            operational text field.  This text is used to show the filename
            a user is transferring, the door that is currently opened, etc.
            To leave the text unchanged, enter * for the text.  For a list
            of status values that expect text in the operational text field,
            refer to the 11 SysOp command in the PCBoard Commands chapter of
            the manual.

 NOTE: if multiple words are entered for name or city you must enclose them
 within quotation marks (e.g. "JOHN DOE" "NOWHERE, USA").

 Status values

 Letter         As shown in PCBMoni     As shown in PCBoard
 ------  ---------------------   ---------------------------
 A       Available for CHAT      Available for CHAT
 B       Out to DOS              Out of Code in DOOR
 C       Chatting with Sysop     Entering a Message
 D       Inside a DOOR           Out of Code in DOOR
 E       Entering a Message      Entering a Message
 F       Viewing A File          Transferring a File
 G       CHATTING with Group     CHATTING with Group
 L       Auto Logoff Pending     Auto Logoff Pending
 M       Message
 N       Chatting w/ Node #      CHATTING with NODE #
 O       Logging Into System     Logging into System
 P       Paging the Sysop        Paging the Sysop
 R       CHAT Request Sent       CHAT Request Sent
 S       Answering Script        Entering a Message
 T       Transferring a File     Transferring a File
 U       Unavailable for CHAT    Unavailable for CHAT
 W       Waiting for Node #      Waiting for Node
 X       Drop to DOS Pending     Drop to DOS Pending
 Y       No Caller this Node     No Caller this Node
 Z       (Inactive Node)


 NOTE:  With the Y and Z status values no name or city parameters are needed.

 Examples

 Making It Appear A Caller Is Online

 Sometimes as a SysOp you may want to list your name in the USERNET.XXX even
 when you are not online.  Your display might look like this:

 (#)   Status                  User
 ---   ---------------------   -----------------------------
   1   Unavailable for CHAT    JOE USER (ANYTOWN, ANYWHERE)
   2   Available for CHAT      JIM USER (ANYWHERE, ANYPLACE)
   3   No Caller Online        SYSOP - NOT CURRENTLY ONLINE

 To accomplish a similar display you would do the following:

 USERNET C:\PCB\MAIN\USERNET.XXX 3 Y N3 N3 "SYSOP - GONE FISHING"

 The two N3s in this example are place-holders for the user name and city.
 When there is no caller online, the text field is displayed instead of the
 user name and city.  If you normally log into a node other than 3, you can
 replace the 3s in this example with the node number you log into.

 Broadcasting All Nodes

 If you want to broadcast all of your nodes from a DOS prompt, you can do so
 using USERNET.  For the example let's say that you need to take your system
 down.  Rather than SysOp chatting with all nodes, you can run a batch file
 which looks like the following:

 USERNET C:\PCB\MAIN\USERNET.XXX ALL M "PLEASE LOG OFF ASAP"

 This example uses the M status value to send the message.  This is quite
 similar to the BR SysOp command in PCBoard.  One thing that is distinctly
 different in this example is that instead of a node number, the word ALL is
 shown.  The word ALL tells USERNET to send this message to ALL nodes.

 NOTE:  If the user is not in PCBoard (i.e., they are in a door), the message
 will not be displayed to the user even when they come back to PCBoard.  You
 may want to pay special attention to who  is in a door when you broadcast a
 message.

 Clearing A Name From The Node Display

 You may run into circumstances when a user name is stuck in the node display.
 This type of scenario is most likely to happen when your bulletin board
 system involves local nodes, floating nodes, and users who reboot their
 system while online.  To clear a user's name out of node 11 on the system,
 you could issue the following command at a DOS prompt:

 USERNET C:\PCB\MAIN\USERNET.XXX 11 Z

 This will make it so that node 11 will not show up on the node display (using
 the WHO user command).

 Drop All Nodes to DOS

 In this example, we will show you how to immediately log off all nodes that
 are currently in PCBoard.  To do this, change all of the node's status to X.
 This action will drop the node to DOS as soon as possible.  If the user is
 currently in a DOOR or some other application, they will be disconnected when
 they return to PCBoard.  To mark all of your nodes to drop to DOS, use the
 following command line:

 USERNET C:\PCB\MAIN\USERNET.XXX ALL X

 When PCBoard reads the USERNET.DAT file, it will see the X status and  will
 disconnect the user.  Before the user is disconnected,  the Automatic Logoff
 Completed message will be displayed.